home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 27 / CU Amiga Magazine's Super CD-ROM 27 (1998)(EMAP Images)(GB)[!][issue 1998-10].iso / CUCD / Programming / JForth / ReadMe < prev    next >
Text File  |  1998-07-07  |  9KB  |  256 lines
  1.  
  2.              Welcome to the JForth PD release
  3.                         6/03/98
  4.  
  5.                   !!!! IMPORTANT !!!!
  6.  
  7.     This JForth package is released as freeware.  
  8.     Permission is hereby given for any third party 
  9.     to reproduce, distribute and modify the JForth 
  10.     software code or any derivative works thereof 
  11.     without any compensation or license.  The JForth 
  12.     software code is provided on an "as is" basis 
  13.     without any warranty of any kind, including, 
  14.     without limitation, the implied warranties of 
  15.     merchantability and fitness for a particular 
  16.     purpose and their equivalents under the laws of 
  17.     any jurisdiction, as well as the provision of 
  18.     support of any kind.
  19.  
  20.     Technical support from Delta Research for this 
  21.     free product is not available.  If, however, you 
  22.     find an error in our release package such as a 
  23.     missing documentation file, or a scrambled 
  24.     archive file, please let us know.
  25.  
  26. ------------------------------------------------------------------
  27. NOTE: JForth PD is distributed in 3 LHA archives named
  28.       J4TH1OF3.LHA, J4TH2OF3.LHA and J4TH3OF3.LHA.  The first 2
  29.       are necessary to install a functional JForth development
  30.       system.  The 3rd contains product documentation in
  31.       RTF format (for use with word processors that understand
  32.       that format) and is highly recommended.
  33. ------------------------------------------------------------------
  34.       
  35.     JForth PD is a complete JForth software development system.  
  36. It is equivalent to the last release of the commercial JForth 
  37. Professional 3.1 package, with AmigaDOS 3.1 includes instead of 
  38. 2.04 and a few bug fixes.  In addition, a soft copy of the
  39. JForth user manual as well as a much later version of 
  40. Textra, the user-friendly text editor, is included.
  41.  
  42.     This file will explain how to install the JForth PD software 
  43. development system on your hard drive.  (The enclosed 
  44. documentation mentions running from floppies, but the 
  45. enclosed WB 3.1 include files are too large for that.  Move
  46. them to a separate floppy and reassign ji: there to run from
  47. floppies).
  48.  
  49. NOTE: Disregard the JForth Pro 3.x installation instructions in 
  50.       the documentation, as well as the Install_JForth 
  51.       installation script in the JTools drawer.  (Both are 
  52.       oriented toward installation from floppies.)  Use the 
  53.       following instructions to install this package...
  54.  
  55. --------------------------------------------------------------
  56.                     INSTALLATION OVERVIEW
  57.  
  58.     Hopefully you have already expanded the three J4TH#OF3 lha 
  59. files, because you are looking at this ReadMe.  I recommend the 
  60. lha files be extracted into the same drawer, which can be removed 
  61. after the installation.
  62.  
  63.     You will then create another drawer and extract the 5 archives 
  64. into it.  You will then perform a small edit to your s:user-startup 
  65. file and finally, reboot your Amiga.  The JForth system will be 
  66. fully functional at that point, ready for you to launch the JForth 
  67. shell (com:JForth) and compile some test programs.
  68.  
  69. --------------------------------------------------------------
  70.                DETAILED INSTALLATION PROCEDURE
  71.  
  72. 1. Create a drawer somewhere on your hard disk.  For this example, 
  73.    we'll assume the pathname of this drawer is "Work:JF"... you 
  74.    should, of course, substitute your own drawer's pathname when 
  75.    you see "Work:JF" in this example.
  76.    
  77. 2. Extract each of the 5 .lha files into Work:JF.  Each will 
  78.    create a drawer with the same name as the respective archive, 
  79.    sans the .lha extension.  When finished, Work:JF should contain 
  80.    the following drawers...
  81.    
  82.         JForth    Extras    JTools    Textra120    JFDocs
  83.  
  84. 3. Add the following 2 lines to your s:user-startup script (if you 
  85.    don't have an s:user-startup file, use s:startup-sequence but 
  86.    insert it before the endcli command)...
  87.    
  88.         assign JFHD: Work:JF
  89.         execute JFHD:Extras/HD-ASSIGNS
  90.  
  91. 4. Save the file, wait 10 seconds, then reboot your Amiga.
  92.  
  93. 5. Launch JForth by one of the following methods...
  94.  
  95.    From Workbench:      double-click on Work:JF/Extras/com/JForth
  96.    From shell, enter:   run com:jforth
  97.  
  98. 6. After JForth presents it's 'ok' prompt, enter:
  99.  
  100.        include jd:load_demos
  101.  
  102. 7. When that finishes compiling, enter:
  103.    
  104.        demo
  105.  
  106. 8. To exit JForth, enter:   BYE
  107.  
  108.    ...then press RETURN
  109.  
  110. ---------------------------------------------------------------------
  111.                    HELPFUL INFO TO GET STARTED
  112.  
  113. Free dictionary space...
  114.  
  115. Note:  When com:JForth initially starts up, it has a free dictionary
  116.        space of about 56K.  This is enough to compile the JForth
  117.        demo, but not larger programs.  You can make this area as large
  118.        as your Amiga has memory to support.  As an example, lets
  119.        create a JForth that has 200K free dictionary space...
  120.        
  121.        1. Run the release com:JForth (see step 5 above) and enter:
  122.        
  123.             200 #K !    ( puts 200 in the 'number-K' JForth variable )
  124.             save-forth com:J200    ( creates a bigger JForth on disk )
  125.             bye                       ( exits the com:JForth program )
  126.             
  127.        2. Run the com:J200 program you just created...
  128.  
  129.           From Workbench:      double-click on Work:JF/Extras/com/J200
  130.           From shell, enter:   run com:J200
  131.           
  132.           Note that the dictionary space at startup is at least 200K.
  133.  
  134. Note: You can run JForth environments from anywhere... they don't have
  135.       to reside in com:
  136.  
  137. ----------------------------------------------------------------------
  138.  
  139. JForth logical assignments...
  140.  
  141.     The 2 startup commands you added to s:user-startup, when executed, 
  142. create some logical assignments for key JForth files.  Some of these
  143. are used internally by the JForth system, others you will use as
  144. you program in JForth, for example, when specifying include files...
  145.  
  146.    include ji:exec/exec.j
  147.    
  148. These  are some of the most important examples...
  149.  
  150.    com: holds the released executable JForth binaries.
  151.    
  152.    ji:  holds the JForth include files (which mirror the C include files)
  153.    
  154.    ju:  holds source for many, many useful utilities
  155.    
  156.    jf:  holds most JForth source code in case you want to rebuild
  157.         com:JForth from com:JKernal
  158.         
  159.    cl:  holds source for CLONE, JForth's standalone application generator
  160.         
  161.    jd:  holds many compileable and cloneable demo source files
  162.    
  163.    jrx: holds ARexx support code
  164.    
  165.    ja:  holds the source for some small but handy applications
  166.    
  167.    jo:  holds source to ODE, JForth's object-oriented dialect
  168.    
  169.    mod: holds pre-compiled utilities such as the assembler, disassembler
  170.         which are dynamically loaded as needed
  171.    
  172.    janim: holds animation support code
  173.   
  174. -----------------------------------------------------------------------
  175.  
  176. How to use CLONE...
  177.  
  178. To create a cloned standalone application...
  179.  
  180. 1. Compile CLONE by entering:
  181.  
  182.        include cl:topfile
  183.  
  184. 2. Compile your application
  185.  
  186. 3. Enter the following:
  187.  
  188.        clone <main>
  189.        
  190.    ...where <main> is the name of your application's main entry point.
  191.  
  192. 4. When that finishes, enter:
  193.  
  194.        save-image <main> Work:myProgram
  195.        
  196.     ...where <main> is the name of your programs main entry point.
  197.     
  198.     and 'Work:myProgram' is the path/filename of your saved application.
  199.     
  200.     Note: add '-icon' to the end of the save-image command line to have
  201.           a default icon created for your program.
  202.           
  203. 5. Enter 'initclone' before performing another clone operation or
  204.    performing a 'save-forth'.
  205.  
  206. ----------------------------------------------------------------------
  207.  
  208.     JForth provides many standard Forth operators, and a wealth of 
  209. custom ones as well as many sophisticated, state-of-the-art 
  210. features.  It is strongly recommended that you read the 
  211. documentation and have it available to get the most out of JForth.  
  212. There is a LOT in JForth that you will never know about otherwise.
  213.  
  214.     The provided documentation is the complete JForth user manual, 
  215. with index.
  216.  
  217. ----------------------------------------------------------------------
  218.  
  219. We hope you enjoy JForth.
  220.  
  221. Mike Haas and Phil Burk
  222. Creators of JForth
  223.  
  224.  
  225.  
  226. P.S. Don't stop reading yet, because there's a...
  227.    
  228.                 JFORTH MAILING LIST AVAILABLE!
  229.                 ==============================
  230.  
  231.    The following is from Martin Randall, a very enthusiastic
  232.    fellow who, at the time of this writing, is doing
  233.    yeoman's work supporting your JForth efforts.  This may
  234.    be the best example... his self-created and 
  235.    self-maintained JForth mailing list.  This can be a real
  236.    boon to JForth users... pooling resources really comes
  237.    in handy!
  238.    
  239.               List instructions from Martin...
  240.  
  241. To subscribe send mail to MDaemon@ChaosSolutions.com and put 
  242. 'Subscribe JForth-List'  as the only line in the body.
  243.  
  244. To Unsubscribe send mail to MDaemon@ChaosSolutions.com and put 
  245. 'Unsubscribe JForth-List'  as the only line in the body.
  246.  
  247. Any problem send a mail to List-Admin@ChaosSolutions.com
  248.  
  249. To get a digest as opposed to individual e-mails send to 
  250. MDaemon@ChaosSolutions.com and put  
  251. 'SET DIGEST JForth-List'  as the only message in the body.
  252.  
  253. To change back to individual mails send to 
  254. MDaemon@ChaosSolutions.com and put 'SET NONDIGEST JForth-List'  
  255. as the only message in the body.
  256.